home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 1 / Ultimedia 1.iso / tools / grafiktools / banner / readme < prev    next >
Text File  |  1994-05-29  |  8KB  |  205 lines
  1.  
  2.  
  3.   ___            _               _____ _       _      _   _
  4.  / _ \ _ __ ___ (_) __ _  __ _  |  ___(_) __ _| | ___| |_| |
  5. | |_| | '_ ` _ \| |/ _` |/ _` | | |_  | |/ _` | |/ _ \ __| |
  6. |  _  | | | | | | | (_| | (_| | |  _| | | (_| | |  __/ |_|_|
  7. |_| |_|_| |_| |_|_|\__, |\__,_| |_|   |_|\__, |_|\___|\__(_)
  8.                    |___/                 |___/
  9.  
  10.  
  11. This is an Amiga port of Figlet, an excellent ASCII font rendering
  12. program described below.
  13.  
  14. This Amiga version is a little different from the original program.
  15. The argument parsing is changed to the AmigaDOS 2.0 "ReadArgs" style
  16. so that you can type "figlet ?" and you will see the following
  17. template:
  18.  
  19.    FONTNAME,DEUTSCH/S,CENTER/S,PARAGRAPH/S,COLUMNS/N,SMUSHMODE/N:
  20.  
  21. You can specify the fontname (without using the keyword) and can
  22. specify any of the other keywords by putting the keyword on the
  23. command line.  For example:
  24.  
  25.     FIGLET CENTER              Use the default font and
  26.                     center the text.
  27.  
  28.     FIGLET smslant COLUMNS 40    Use the smslant font and
  29.                     set the column width to 40.
  30.  
  31. (the keywords don't need to be upper case).
  32.  
  33. Once you start the program, it will accept any input you type and
  34. print it's output back in the console.  A handy use for this program
  35. is to run it in a console window and try the various options
  36. until you get the text you want, and then cut it from the console
  37. window and paste it into whatever program you want it in.
  38.  
  39. As Figlet itself changes, I will try and keep this port current.  The
  40. most current Amiga version will be found on Portal.  This Amiga port
  41. is by Steve Tibbett, and I take all credit for any bugs in this
  42. version - if you find a problem, please send the bug report to me,
  43. not to the original authors.  If it really is a problem with Figlet
  44. and not my port of it, then I will forward it to them.
  45.  
  46.  
  47.     Name:        Steve Tibbett
  48.     Portal:        SteveX
  49.     Internet:    SteveX@cup.portal.com
  50.     Compuserve:    72627,1325
  51.     Bix:        s.tibbett
  52.     BBS:        613-731-3419
  53.     Voice:        613-731-5316
  54.  
  55.  
  56. ---------------------------> Original Docs Below <------------------------------
  57.  
  58.  
  59. About figlet (Frank, Ian & Glenn's Letters) release 2.0, August 9, 1993
  60. ----------------------------------------------------------------------
  61.  
  62. figlet is a program that creates large characters out of ordinary
  63. screen characters.  figlet can create characters in many different
  64. styles and can "smush" these characters together in various ways.
  65. figlet output is generally reminiscent of the sort of "signatures" many
  66. people like to put at the end of e-mail and UseNet messages.  Some
  67. example figlet output is given below.
  68.  
  69. If you like figlet (hey, even if you _hate_ figlet), please send an
  70. e-mail message to spectre@uiuc.edu or figlet@uiuc.edu.
  71.  
  72. [Note: Apple IIGS GNO users having no "C" compiler can contact Jawaid
  73. Bazyar at <bazyar@csn.org> for a pre-compiled GNO version of figlet.]
  74.  
  75.  
  76. Files
  77. -----
  78.  
  79. README    -- This file.
  80. figlet.c  -- The figlet source code.
  81. Makefile  -- The figlet makefile.  Used by the make command.
  82. figlet.6  -- The figlet man(ual) page.
  83. <xxx>.flf -- All files ending in ".flf" are figlet font files.
  84.  
  85.  
  86. Installing figlet
  87. -----------------
  88.  
  89. First decide in which directories figlet, and the figlet font files
  90. (the ".flf" files) will be stored (usually "/usr/games" and
  91. "/usr/games/lib/figlet.dir") and which will be the default font (we
  92. recommend "standard.flf").
  93.  
  94. Edit "Makefile", and set the variables DEFAULTFONTDIR, DEFAULTFONTFILE
  95. and OLD_DIR_STRUCTS to the appropriate values.  Set DEFAULTFONTDIR to
  96. be the full pathname of the directory in which you will keep the figlet
  97. font files.  Set DEFAULTFONTFILE to be the filename of the default
  98. font.  OLD_DIR_STRUCTS should normally be 0.
  99.  
  100. Then, in the directory with the figlet source in it, type "make
  101. install".
  102.  
  103. If the program fails to compile, set OLD_DIR_STRUCTS to 1 in Makefile,
  104. and type "make install" again.  (Setting OLD_DIR_STRUCTS to 1 makes
  105. figlet use an older method of reading directories.  On newer systems,
  106. this method will often compile without errors, but will not run
  107. properly, so OLD_DIR_STRUCTS should only be set to 1 if figlet will not
  108. compile otherwise.)
  109.  
  110. If you cannot, or do not want to install the man pages, you can still
  111. probably read it using
  112.     nroff -man figlet.6 | more
  113. and you should not use "make install" but just "make" and then copy the
  114. files manually.
  115.  
  116. If space is a problem, the only files you absolutely must have to run
  117. figlet are "figlet" (the executable) and at least one font (preferably
  118. the one you chose to be the default font).
  119.  
  120. We have successfully compliled figlet on the following systems:
  121.  
  122. Hardware              Operating System
  123.  
  124. Sun SPARC             SunOS V4.1.3
  125. SGI Iris 4D/25GT      IRIX V4.0.5
  126. SGI Iris 4D/340VGX    IRIX V4.0.5
  127. SGI Iris Skywriter    IRIX V4.0.5
  128. Cray 2                UNICOS V6.1
  129. Cray Y-MP             UNICOS V6.1
  130. Sequent S81           DYNIX V3.1.1
  131. Convex C240           ConvexOS V10.1
  132. IBM RS/6000           AIX V3
  133. HP 9000/375           HP-UX V7.0
  134. NeXT Mach             NeXTstep V3.0
  135.  
  136.  
  137. Using figlet
  138. ------------
  139.  
  140. At the shell prompt, type "figlet".  Then type, say, "Hello, world!"
  141. and press return.  "Hello, world!" in nice, big, designer characters
  142. should appear on your screen.  If you chose standard.flf to be the
  143. default font, you should see
  144.  _   _      _ _                             _     _ _
  145. | | | | ___| | | ___    __      _____  _ __| | __| | |
  146. | |_| |/ _ \ | |/ _ \   \ \ /\ / / _ \| '__| |/ _` | |
  147. |  _  |  __/ | | (_) |   \ V  V / (_) | |  | | (_| |_|
  148. |_| |_|\___|_|_|\___( )   \_/\_/ \___/|_|  |_|\__,_(_)
  149.                     |/
  150. (By the way, the above is meant to be diplayed in a monospaced font.)
  151. Then type something else, or type an EOF (typically control-D) to quit
  152. figlet.
  153.  
  154. Now you can send the output of figlet to a file (e.g., "figlet > file")
  155. and e-mail it to your friends (who will probably say, "Wow!  It must
  156. have taken you hours to put that together!")
  157.  
  158. To use other fonts, use the "-f" command line option.  For example, if
  159. you had said "figlet -f smslant" above, you would have seen
  160.    __  __    ____                         __   ____
  161.   / /_/ /__ / / /__      _    _____  ____/ /__/ / /
  162.  / __  / -_) / / _ \_   | |/|/ / _ \/ __/ / _  /_/
  163. /_/ /_/\__/_/_/\___( )  |__,__/\___/_/ /_/\_,_(_)
  164.                    |/
  165.  
  166. Here are some other useful command line options:
  167.  
  168. -c  center -- centers the output of figlet.
  169. -t  terminal -- figlet asks your terminal how wide it is, and uses
  170.     this to determine when to break lines.  Normally, figlet assumes
  171.     80 columns so that people with wide terminals won't annoy the
  172.     people they e-mail figlet output to.
  173. -D  Deutsch -- switches to the German character set.  Turns `[', `\'
  174.     and `]' to umlauted A, O and U, respectively.  `{', `|' and `}'
  175.     turn into the respective lower case versions of these.  `~' turns
  176.     into s-z.
  177. -p  paragraph mode -- eliminates some spurious line breaks when piping
  178.     a multi-line file through figlet.
  179. -F  Fonts -- lists the available figlet fonts.
  180. -v  version -- prints information about your copy of figlet.
  181.  
  182. For in-depth explanations of these and other otions, see the man page.
  183.  
  184.  
  185. Other Stuff
  186. -----------
  187.  
  188. Although you don't have to design your own fonts to use figlet, we'd
  189. certainly like it if lots of people did make up new figlet fonts.  If
  190. you feel like giving it a try, see the "FONT FILE FORMAT" section of
  191. the man page.
  192.  
  193. See "Other Things to Try" in the EXAMPLES section of the man page
  194. for...  well... other things to try.
  195.  
  196.  
  197. Authors
  198. -------
  199.  
  200. figlet was written mostly by Glenn Chappell <ggc@uiuc.edu>.  The
  201. author not being an e-mail fanatic, most correspondence (bug reports,
  202. rave reviews, etc.) should be directed to his secretary (who is
  203. definitely an e-mail fanatic), Ian Chai <spectre@uiuc.edu> (or
  204. figlet@uiuc.edu).
  205.